home *** CD-ROM | disk | FTP | other *** search
/ The 640 MEG Shareware Studio 2 / The 640 Meg Shareware Studio CD-ROM Volume II (Data Express)(1993).ISO / mailers / hm11a.zip / SQNOTES.TXT < prev    next >
Text File  |  1992-10-24  |  7KB  |  145 lines
  1.  
  2. =======================================================================
  3.  
  4.                  Notes on using Harmony BBS with Squish
  5.  
  6.    This file has been included to ease the integration of the popular
  7.          program Squish (tm) by Scott Dudley with Harmony BBS.
  8.  
  9.    You should have a full understanding of both programs before hand!
  10.  
  11. =======================================================================
  12.  
  13.         With the new verison of Harmony BBS (v1.1), came the arrival of
  14.         a new format for all the message bases and the post office.
  15.         This format was originally writtem by Scott Dudley for the
  16.         Maximus BBS program, but has become widely accepted throughout
  17.         the BBS community because of it flexibility and speed.
  18.  
  19.         Anyway, enough small talk, lets get to it ...
  20.  
  21.                           ===================
  22.  
  23.         Step 1 :  Make sure that you have defined all of the message
  24.         bases that you would like on Harmony BBS.  More can be added
  25.         later, but it will take a lot more text editing.
  26.  
  27.         Step 2 : Load up HMC from version 1.1 of Harmony BBS, and move
  28.         to the message base section.  Now go to the menu choice called
  29.         SQUISH and run it.
  30.  
  31.         HMC will scan through your message bases and create a text file
  32.         called AREAS.SQU in your main Harmony BBS directory.
  33.  
  34.         Step 3 : Exit HMC, and with your favorite text editor, load up
  35.         your SQUISH.CFG file.
  36.  
  37.         The first thing you have to configure is the post office section
  38.         of your BBS.
  39.  
  40.         Go to the message areas section within your squish.cfg file, and
  41.         change your NETMAIL area to read :
  42.  
  43.         NetArea NETMAIL  C:\HM\SYSTEM\NETMAIL   -$m300 -$d365  -p{net_addr}
  44.  
  45.         The directory (c:\hm\system\netmail) should point to Harmony
  46.         BBS's system directory, and MUSY have the word NETMAIL attached
  47.         to the end of it.
  48.  
  49.         The -p{net_addr} parameter is optional, and should only be
  50.         there if you are running a networked BBS.  For more information
  51.         on the -p parameter, refer you the Squish documentation.
  52.  
  53.         Another important note should be made here.  If you are running
  54.         a front end mailer that expects your net mail to be in the
  55.         classic Fidonet *.MSG format (such as Front Door), you should
  56.         NOT define you net mail directory in the way just described.  If
  57.         you do, your mailer will never be able to find your netmail and
  58.         will become fairly useless.  Instead, you are going to have to
  59.         create 2 separate mail areas.  One for Harmony BBS, and another
  60.         for your mailer.  Example :
  61.  
  62.         NetArea  NETMAIL    d:\hm\mail             -p{net_addr}
  63.         EchoArea HMMAIL     d:\hm\system\netmail   -$m300 -$d365 -p{net_addr}
  64.  
  65.         Notice the Harmony BBS's mail is no longer recognized as a
  66.         netmail area, rather an EchoArea.  This setup just seemed to
  67.         work better for this type of configuration, but you can try
  68.         setting up both as a NetArea.
  69.  
  70.         The $m300 and $d365 tells squish to only allow 300 private
  71.         messages within Harmony's post office, and keep them for a
  72.         maximum of 365 days.  This is what Harmony BBS expects to see
  73.         also, so those numbers should not be changed.
  74.  
  75.         Step 4 : Now simply merge the AREAS.SQU file that HMC has
  76.         created into the rest of the areas section in squish.  There are
  77.         only 2 things which you may have to change in each of these
  78.         lines.  Here is an example line from within the AREAS.SQU file :
  79.  
  80.         EchoArea FIRESIDE C:\TELE\MSGS\Fireside  -$m40 -$d14  -p1:260/445
  81.  
  82.         IF you have not defined a NETNAME from within Harmony BBS during
  83.         each message bases creation, the second word (FIRESIDE) will not
  84.         be present.  But since Squish looks for this name, you must add
  85.         one.  If the message base is a networked message base, it MUST
  86.         match the area name expected by the network.  If the message
  87.         base is a local message base to your system only, this line MUST
  88.         still be in the squish.cfg file, otherwise, no houework will
  89.         ever be done to it.  Simply create an artificial area name, and
  90.         place it there.
  91.  
  92.         The only other thing that may have to be changed in each line is
  93.         the -p{net_addr} parameter.  If you are not running a networked
  94.         BBS at all, simply erase that parameter from the line.  If you
  95.         are running it, make sure the that net_addr coincides with the
  96.         address required for that message base.
  97.  
  98.         Finally, if you are hosting that message base for any other
  99.         systems, you will have to add those addresses manually to each
  100.         area.
  101.  
  102.         DO NOT change the 3rd parameter on this line of text.  It points
  103.         to the EXACT directory and file of each message base.  It is used
  104.         from both within Squish and Harmony BBS.
  105.  
  106.                           ===================
  107.  
  108.         Finally, some notes on maintaining you message bases.
  109.  
  110.         First, and most importantly -- Whenever mail is IMPORTED into
  111.         your message bases, or whenver SQPACK is executed, HMHOUSE -M
  112.         should be run immediately afterwards.  Doing so lets Harmony BBS
  113.         know of any new changes to all the message bases.  For those of
  114.         you who were running Harmony BBS v1.0, you will be pleased to
  115.         see the amount of time HMHOUSE -M now takes!
  116.  
  117.         Secondly, it is propably a good idea to run SQPACK at least once
  118.         a day.  For those not familiar with it, you would run it is sort
  119.         of like this :
  120.  
  121.         SQPACK c:\hm\msgs\*.sqd
  122.  
  123.         You should also run it on your post office squish file as much
  124.         as possible also :
  125.  
  126.         SQPACK c:\hm\system\netmail.sqd
  127.  
  128.         SQPACK should ALWAYS be run after a user has deleted a message
  129.         from within a message base.  How do you know when this is done
  130.         you ask?   Ahhh.. whenever someone deleted a message, Harmony
  131.         BBS will create a semaphore file called DELETED.MSG in its home
  132.         directory.  Your batch file should look for the existance of
  133.         this file, and call SQPACK if it it is found.  Make sure your
  134.         batch file also deletes DELETED.MSG otherwise it will be called
  135.         constantly after each user logs off (not that this is a bad
  136.         thing, but it will cause a lot of excess house work to be done).
  137.         Also be sure to run HMHOUSE -M after SQPACK.
  138.  
  139.                     ================================
  140.  
  141.         Well, thats pretty much the long and short of it.  It isn't
  142.         really difficult at all to do, just make sure you know the
  143.         concepts before doing the work.  It makes life a lot easier.
  144.  
  145.